Manager: Window Manager


Carbon supports the Window Manager. Be aware, however, that if you use custom window definition procedures (also known as WDEFs), you must compile them as PowerPC-native code. In addition:

* Your application must use the functions defined by the Window Manager whenever it creates and disposes of Window Manager data structures. For example, instead of directly creating and disposing of window records, applications must call such Window Manager functions as GetNewCWindow and DisposeWindow.

* You must revise your application so that it accesses Window Manager data structures only through accessor functions.

* You are encouraged to adopt the standard Mac OS 8 window definition procedures in your application. Applications that use the standard Mac OS 8 window definition procedures inherit the Mac OS 8 human interface appearance. Applications that use custom window definition procedures work correctly, but because custom definition procedures invoke their own drawing routines, Mac OS 8 can't draw these applications with the current appearance.

Supported  AreFloatingWindowsVisible

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  BeginUpdate

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  BeginWindowProxyDrag

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  BringToFront

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  CalcVis

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  CalcVisBehind

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  CallDeskHookProc

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  CallWindowDefProc

Supported  ChangeWindowAttributes

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  ChangeWindowPropertyAttributes

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  CheckUpdate

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  ClipAbove

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  CloneWindow

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Unsupported  CloseWindow

The CloseWindow function is not supported because developers do not allocate their own memory for windows in Carbon. Use the DisposeWindow function to remove a window instead. Not available in Carbon.

Supported  CollapseAllWindows

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  CollapseWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  ConstrainWindowToScreen

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Under Evaluation  CopyWindowTitleAsCFString

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Supported  CreateCustomWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  CreateNewWindow

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  CreateWindowFromCollection

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  CreateWindowFromResource

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  DebugInvertVisRegion

Supported  DebugPrintWindow

Supported  DebugPrintWindowList

Unsupported  DeskHookProcPtr

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Under Evaluation  DisableSingleDocumentMode

Unsupported  DisposeDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  DisposeWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  DisposeWindowDefUPP

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  DisposeWindowPaintUPP

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  DragGrayRgn

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  draggrayrgn

Use DragGrayRgn instead. Not available in Carbon.

Not Recommended  DragTheRgn

Use DragGrayRgn instead. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  DragWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  dragwindow

Use DragWindow instead. Not available in Carbon.

Supported  DrawGrowIcon

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  DrawNew

Use ReshapeCustomWindow. Not available in Carbon.

Under Evaluation  EnableSingleDocumentMode

Supported  EndUpdate

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  EndWindowProxyDrag

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  FindWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  findwindow

Use FindWindow instead. Not available in Carbon.

Supported  FindWindowOfClass

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  FrontNonFloatingWindow

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  FrontWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  GetAuxWin

Remove application reliance on AuxWinRec data structures; in the future, the information in these structures may be invalid or unavailable to applications. Not available in Carbon.

Unsupported  GetCWMgrPort

Carbon does not support accessing the Window Manager port. You should draw into your own graphics port instead. Not available in Carbon.

Supported  GetFrontWindowOfClass

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetGrayRgn

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetNewCWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetNewWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetNextWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetNextWindowOfClass

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  GetSheetWindowParent

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Supported  GetWindowAttributes

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowBounds

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowClass

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowContentColor

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowContentPattern

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Unsupported  GetWindowControlList

Accessing the window control list is not supported in Carbon. Use the Control Manager's control embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  GetWindowFeatures

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowFromPort

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  GetWindowGoAwayFlag

Use GetWindowAttributes instead.

Under Evaluation  GetWindowGreatestDevice

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Supported  GetWindowIdealUserState

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowKind

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowList

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowOwnerCount

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowPic

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowPort

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowPortBounds

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowProperty

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowPropertyAttributes

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowPropertySize

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowProxyAlias

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowProxyFSSpec

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowProxyIcon

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowRegion

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  GetWindowSpareFlag

Use GetWindowAttributes instead.

Supported  GetWindowStandardState

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWindowUserState

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  GetWindowWidgetHilite

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Unsupported  GetWMgrPort

Carbon does not support accessing the Window Manager port. You should draw into your own graphics port instead. Not available in Carbon.

Supported  GetWRefCon

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GetWTitle

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  getwtitle

Use GetWTitle instead. Not available in Carbon.

Supported  GetWVariant

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  GrowWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  growwindow

Use GrowWindow instead. Not available in Carbon.

Supported  HideFloatingWindows

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Under Evaluation  HideSheetWindow

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Supported  HideWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  HiliteWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  HiliteWindowFrameForDrag

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Unsupported  InitFloatingWindows

There is no need to initialize this Window Manager functionality because the shared library is loaded as needed. Not available in Carbon.

Unsupported  InitWindows

InitWindows is not supported in Carbon. There is no need to initialize the Window Manager because the shared library is loaded as needed. Not available in Carbon.

Supported  InstallWindowContentPaintProc

Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

Unsupported  InvalRect

Calls InvalWindowRect, which takes a window pointer as an additional parameter.

Invalidation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Unsupported  InvalRgn

Calls InvalWindowRgn, which takes a window pointer as an additional parameter. Invalidation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Supported  InvalWindowRect

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  InvalWindowRgn

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Unsupported  InvokeDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  InvokeWindowDefUPP

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  InvokeWindowPaintUPP

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  IsSingleDocumentModeEnabled

Supported  IsValidWindowPtr

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowCollapsable

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowCollapsed

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowHilited

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowInStandardState

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowModified

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowPathSelectClick

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowUpdatePending

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  IsWindowVisible

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  MoveWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  MoveWindowStructure

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Modified  NewCWindow

In Carbon, you cannot pass your own storage in to the wStorage parameter. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  newcwindow

Use NewCWindow instead. Not available in Carbon.

Unsupported  NewDeskHookProc

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Unsupported  NewDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Modified  NewWindow

In Carbon, you cannot pass your own storage in to the wStorage parameter.

In Carbon, NewWindow is functionally equivalent to the NewCWindow, in that NewWindow returns a color window instead of a monochrome window. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  newwindow

Use NewCWindow instead. Not available in Carbon.

Supported  NewWindowDefProc

Supported  NewWindowDefUPP

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  NewWindowPaintUPP

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  PaintBehind

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  PaintOne

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  PinRect

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  pinrect

Use PinRect instead. Not available in Carbon.

Supported  RemoveWindowProperty

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  RemoveWindowProxy

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  RepositionWindow

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  ReshapeCustomWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  ResizeWindow

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Unsupported  SaveOld

Use ReshapeCustomWindow. Not available in Carbon.

Supported  ScrollWindowRect

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  ScrollWindowRegion

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  SelectWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  SendBehind

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  SetDeskCPat

You can no longer affect the desktop under Carbon, so SetDeskCPat has been removed from Carbon. There is no replacement function. Not available in Carbon.

Supported  SetPortWindowPort

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  SetWinColor

Use SetWindowContentColor. Not available in Carbon.

Unsupported  SetWindowAttributes

Use ChangeWindowAttributes instead.

Supported  SetWindowBounds

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowContentColor

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowContentPattern

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Unsupported  SetWindowControlList

Accessing the window control list is not supported in Carbon. Use the Control Manager's control embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  SetWindowIdealUserState

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowKind

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowModified

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowPic

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowProperty

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowProxyAlias

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowProxyCreatorAndType

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowProxyFSSpec

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowProxyIcon

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  SetWindowStandardState

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  SetWindowTitleWithCFString

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Supported  SetWindowUserState

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  SetWRefCon

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  SetWTitle

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  setwtitle

Use SetWTitle instead. Not available in Carbon.

Supported  ShowFloatingWindows

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  ShowHide

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Under Evaluation  ShowSheetWindow

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Supported  ShowWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  SizeWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  StoreWindowIntoCollection

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  TrackBox

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  trackbox

Use TrackBox instead. Not available in Carbon.

Supported  TrackGoAway

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Unsupported  trackgoaway

Use TrackGoAway instead. Not available in Carbon.

Supported  TrackWindowProxyDrag

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  TrackWindowProxyFromExistingDrag

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  TransitionWindow

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Under Evaluation  TransitionWindowAndParent

Available in Mac OS 8.1 and later when Carbon 1.1 or later is present.

Unsupported  ValidRect

Calls ValidWindowRect, which takes a window pointer as an additional parameter. Validation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Modified  ValidRgn

Calls ValidWindowRgn, which takes a window pointer as an additional parameter. Validation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in Carbon.

Supported  ValidWindowRect

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  ValidWindowRgn

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  WindowDefProcPtr

Under Evaluation  WindowPaintProcPtr

Supported  WindowPathSelect

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

Supported  ZoomWindow

Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

Supported  ZoomWindowIdeal

Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 5/11/2000. Copyright © 1999, 2000 Apple Computer, Inc. All rights reserved.